home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 6 / QRZ Ham Radio Callsign Database - Volume 6.iso / mac / files / f6fbb / hbserv29.exe / REQHB.DOC < prev    next >
Text File  |  1993-03-11  |  6KB  |  166 lines
  1.                         REQHB 2.9 for FBB and HamBase
  2.                         (C) 1993 by Dean R. Madsen, KE0WO
  3.                         KE0WO @ KE0WO.#NWIA.IA.USA.NA
  4.                         Internet: MADSENDEAN@BVC.EDU
  5.  
  6.         This file contains a BRIEF overview about how to install and run
  7. the REQHB Server.
  8.  
  9. Features:
  10.  
  11. - Is the only server that I know of that allows the FBB BBS to get Ham Base
  12.   information.
  13.  
  14. - Supports county data using HAMBASE.EXE v 2.62
  15.  
  16. - Calculates the date of birth for each call (if the info is available)
  17.  
  18. - Supports the DX QSL manager data
  19.  
  20. - Supports the Russian callbook data
  21.  
  22. - Allows the SysOp to add text to outgoing messages (ie: j-Com copyright)
  23.  
  24. - Scans the R: routing lines (if any) to find the originator's home BBS
  25.  
  26. - The program's code is compressed, saving disk space
  27.  
  28. - The server runs as soon as a message is received for it allowing very fast
  29.   turn around times for replies.
  30.  
  31. - The server is FREE!
  32.  
  33. - Support for the server will continue in the future.  If you want a feature
  34.   that the server does not have, PLEASE TELL ME!  I can't think of all the
  35.   features that might be desired.  If you want the server to support one of
  36.   j-Com's optional additions to Ham Base (such as the old call data), tell
  37.   me how hambase outputs the additional data in its comma delimited form.
  38.  
  39.  
  40.  
  41. Known bugs(sort of):  I do not believe that this server will work with  
  42.                       Ham Base 3.0, which is about 160K.  It is just
  43.                       too big to run inside another program in FBB.
  44.  
  45.  
  46. ------------------------Getting started-------------------------------------
  47.  
  48.  
  49. First copy the REQHB.EXE file to the \FBB\BIN directory.
  50.  
  51. Now the REQHB.CFG file needs to be configured.  This file HAS to be in the
  52. C:\FBB directory.
  53.  
  54. ------------------------C:\FBB\REQHB.CFG------------------------------------    
  55.     
  56.     The first line is the drive\path\program name of the HamBase program that
  57. searches the hambase data and looks up callsigns.  On my demo version of
  58. HamBase the program was HB.EXE .  You must include the  extension of the
  59. program name.
  60.  
  61. The second line is the callsign of this  BBS.  Do not include SSID's here.
  62.  
  63. The third line sets the callsign that the callsign lookup will be addressed
  64. from.  This may be the callsign of the BBS Sysop or an "alias"  such as HB
  65. or REQHB.
  66.  
  67. The next line is just a number.  This sets how many lines of text you want 
  68. added to the reply message when it is generated.  This is useful for a short
  69. message telling where your system is at and adding the j-Com copyright.
  70.  
  71. The last lines are the lines of text put in the reply message preceeding the
  72. information from HamBase.  Make sure that the number of line of texts matches
  73. the number in the previous parameter.  Also you are limited to 50 lines of
  74. text with a maximum length of 80 characters.
  75.  
  76. *** NOTE: The people at j-Com ask that you put their copyright line in the
  77.           reply message if you are going to use their product over the air.  
  78.           This line should looks something like this:
  79.  
  80. HamBase Retrieval System V2.59 (c) 1992 j-Com
  81.  
  82.           where the V2.59 is the version of the Hambase program you have.
  83.          
  84. ----------------------INIT.SRV-----------------------------------------------
  85. Now the server has to be set up at the end of your INIT.SRV file.  Include
  86. the following lines:
  87.  
  88. REQQTH REQHB Lookup callsigns
  89. HB REQHB Lookup callsigns
  90. REQCB REQHB Lookup callsigns
  91. REQHB REQHB Lookup callsigns
  92.  
  93. That is it!  Now REQHB should be able to look up info from messages sent to
  94. REQHB, HB, REQQTH, or REQCB.
  95.  
  96. Now you will have to reboot the BBS program for the changes to take effect.
  97.  
  98.  
  99. Now to actually look up a call:
  100. First, send a personal type message to one of the aliases you defined in the
  101. INIT.SRV file (HB, REQCB, REQHB, or REQQTH). 
  102.  
  103. Now for the subject of the message you may list the callsigns you want looked
  104. up.  You may use commas (,) and spaces to separate the callsigns.
  105. *** Note: The maximum length for the subject of a message is around 30
  106.           characters.  Do not exceed this.
  107.           
  108. The text of the message may either be blank or contain more calls that you
  109. want looked up.  One call per line.  When you are done, enter a control-z or
  110. /EX to end the message.
  111.  
  112. Now the server does its thing, runs the HamBase program, and puts the data
  113. in a readable form for the BBS to import. The BBS is supposed to import
  114. messages immediately after a server is run and once every minute.  It is 
  115. advisable that a user type LL 1 to check and see if he/she has a reply 
  116. containing the results of the callsign lookup.  If the local console is in 
  117. use by the Syop then the reply will not be imported until sometime after the 
  118. console channel is free.  If the console channel is not busy, I would be very 
  119. surprised if there is not a reply waiting within 30 seconds after the message
  120. is written.
  121.  
  122. A message sent to the server may look simular to this:
  123.  
  124.  
  125. SP HB
  126. KE0WO,W1AW,W0ABC,W0XYZ
  127. AA6BB
  128. WD0A
  129. AA0A
  130. /EX
  131.  
  132. -----------------------------Conclusion-------------------------------------
  133.  
  134. 1. This software is freeware to the amateur community. It may not be sold.
  135.    It may be freely copied and distributed, but at no charge exceeding the
  136.    medium and shipping.
  137.  
  138. 2. No warranty is expressed or implied and incidental damages resulting from
  139.    the use of this software are solely the responsibility of the user. While
  140.    the software works fine, and I am willing to give it to the amateur 
  141.    community, I am not willing to assume any liabilty for it crashing your
  142.    computer or its peripherals. (It has not done that on any machine we have
  143.    run it on...this is just legal junk to prevent someone from holding me
  144.    responsible for being generous enough to give this server away as a 
  145.    service to the FBB community.)
  146.  
  147. 3. Feedback on desired features, bugs, etc. are encouraged. 
  148.  
  149. 4. I would like to thank N0AN and K0CQ for their encouragement, ideas for
  150.    improvements and for testing my multiple versions of this program.
  151.    This server would not exist nor support the county data, DX data or
  152.    Russian callbook data without Hasan, N0AN.
  153.  
  154. Good luck and 73,
  155. Dean - KE0WO
  156.  
  157. US Snail:  Dean R. Madsen, KE0WO
  158.            P. O. BOX 303
  159.            Storm Lake, IA  50588
  160.  
  161. Packet:    KE0WO @ KE0WO.#NWIA.IA.USA.NA
  162.  
  163. Internet:  MADSENDEAN@BVC.EDU
  164.  
  165.  
  166.